home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / docs / ascii / internet / nhelp411 / domain < prev    next >
Encoding:
Text File  |  1992-12-30  |  13.5 KB  |  362 lines
  1. ======                                              NOSview [301]
  2. domain
  3. ======
  4.  
  5.  
  6. The 'domain' commands control the-name-to-Internet-address
  7. mapping software.
  8.  
  9. NOS translates domain names (e.g. "ns9bob.ampr.org.") to IP
  10. addresses (e.g. "44.199.41.1") through the use of an Internet
  11. Domain Name resolver and a local "cache" file, /domain.txt.
  12.  
  13. Whenever the user specifies a domain name, the local cache is
  14. searched for the desired entry.  If it is present, it is used; if
  15. not, and if domain name server(s) have been configured, a query
  16. is sent over the network to the current server.
  17.  
  18. If the server responds, the answer is added to the /domain.txt
  19. file for future use.  If the server does not respond, any
  20. additional servers on the list are tried in a round-robin fashion
  21. until one responds, or the retry limit is reached (see the
  22. 'domain retry' command).
  23.  
  24. If /domain.txt does not contain the desired entry and there are
  25. no configured domain name servers, then the request immediately
  26. fails.
  27.  
  28. If a domain name server is available, and if all references to
  29. hosts in /autoexec.nos are in IP address format, then it is
  30. possible to start with a completely empty /domain.txt file and
  31. have NOS build it for you.
  32.  
  33. However, you may wish to add your own entries to /domain.txt,
  34. either because you prefer to use symbolic domain names in your
  35. /autoexec.nos file or you don't have access to a domain server
  36. and you need to create entries for all of the hosts you may wish
  37. to access.
  38.  
  39.  
  40. Address Records
  41. ---------------
  42. Each entry in /domain.txt takes one line, and the fields are
  43. separated by any combination of tabs or spaces. For example:
  44.  
  45.           ns9bob.ampr.org.   IN   A   44.199.41.1
  46.  
  47. The host "ns9bob" is in domain ".ampr.org.".
  48.  
  49. "IN" is the class of the record.  It means Internet, and it will
  50. be found in all entries.
  51.  
  52. "A" is the type of the record, and it means that this is an
  53. address record.  Domain name "ns9bob.ampr.org" therefore has
  54. Internet address 44.199.41.1.
  55.  
  56. By setting the default domain to ampr.org. (with the command
  57. 'domain suffix ampr.org.') you can then talk to Bob with commands
  58. like 'telnet ns9bob' or 'finger ns9bob'.
  59.  
  60.  
  61. Canonical Name Records
  62. ----------------------
  63. Another possible entry in /domain.txt is the "CNAME" (Canonical
  64. Name) record. For example:
  65.  
  66.           bob.ampr.org.   IN   CNAME   ns9bob.ampr.org.
  67.  
  68. This says that domain name "bob" is actually an alias (or
  69. "nickname") for the primary (or "canonical") domain name
  70. "ns9bob".  When a domain name having a CNAME record is given to
  71. NOS, the system automatically follows the reference to the
  72. canonical name and returns the IP address associated with that
  73. entry.
  74.  
  75. Thus if you wish to use Bob's BBS, you may say either 'telnet
  76. ns9bob' or 'telnet bob'.
  77.  
  78.  
  79. Mail Exchanger Records
  80. ----------------------
  81. Yet another type of entry supported by NOS is the "MX" (Mail
  82. Exchanger) record.  For example:
  83.  
  84.           ns9zzz.ampr.org.  IN  MX  0  ns9mhb.ampr.org.
  85.  
  86. This states that mail addressed to ns9zzz is to be sent to ns9mhb
  87. for onward transmission.  The parameter "0" is the preference
  88. value.  Zero means highest preference.
  89.  
  90. There could be several records for ns9zzz, each with a different
  91. preference value, and the mail forwarding program will attempt to
  92. send the mail in order of preference.  For example:
  93.  
  94.          ns9zzz.ampr.org.   IN  MX  0  ns9mhb.ampr.org.
  95.                             IN  MX 10  ns9gwb.ampr.org.
  96.                             IN  MX 20  ns9gwc.ampr.org.
  97.  
  98. You can also use wildcards in these entries.  For example:
  99.  
  100.          ns9zzz.ampr.org.   IN  MX  0  ns9mhb.ampr.org.
  101.          *.ns9zzz.ampr.org. IN  MX  0  ns9mhb.ampr.org.
  102.  
  103. The first entry handles mail addressed to ns9zzz, and the second
  104. entry handles other hosts at ns9zzz (e.g. "pc.ns9zzz.ampr.org.").
  105.  
  106. ****  In order to use MX entries, you need to give the command
  107. ****  'smtp usemx on'.
  108.  
  109.  
  110. Other Record Types
  111. ------------------
  112. Additional types of records, include NS (name server) and SOA
  113. (start of authority) may appear in /domain.txt from remote server
  114. responses.  These are not currently used by NOS but are retained
  115. for future development (such as the incorporation of a domain
  116. name server into NOS itself).
  117.  
  118.  
  119. Time-to-Live
  120. ------------
  121. Entries added automatically by NOS will have an additional field
  122. between the domain name and the class (IN) field.  For example:
  123.  
  124.           ns9ken.ampr.org.   3600  IN   A   44.199.41.2
  125.  
  126. This is the time-to-live value, in seconds, associated with the
  127. record received from the server.  Clients (such as NOS) caching
  128. these records are supposed to delete them after the time-to-live
  129. interval has expired, allowing for the possibility that the
  130. information in the record may become out of date.
  131.  
  132. Most implementations of NOS will decrement the TTL to zero, but
  133. will not delete the record unless the "clean" flag is on (see the
  134. 'domain cache clean' command).
  135.  
  136. When a remote server is not available, the old entry will be
  137. used.
  138.  
  139. When the TTL value is missing, the record will never expire, and
  140. must be managed by hand.  Since /domain.txt is a plain text file,
  141. it may be easily edited by the user to add, change or delete
  142. records.
  143.  
  144.  
  145. The 'domain' commands are now described:
  146. _________________________________________________________________
  147. domain addserver <host> [<host> ... ]
  148. _________________________________________________________________
  149. Add one or more domain name servers to the list of name servers.
  150.  
  151. Note that when this command is given in /autoexec.nos, the 'ip
  152. address' command should given before any 'domain' commands are
  153. used.  (If not, no IP address is known to specify in the "from IP
  154. address" and an answer will never be recognized, or worse, just
  155. plain hangs the system).
  156.  
  157. >> Example: domain addserver ns9srv
  158.  
  159.  
  160. _________________________________________________________________
  161. domain cache clean [off|on]                          Default: off
  162. _________________________________________________________________
  163. Display or set the discarding of expired resource records.
  164. Expired records have their timeout value decremented to zero.
  165.  
  166. Normally resource records get a default timeout value of 1800
  167. seconds.  After this time they are considered "old" and if
  168. referenced again the domain name resolver should be enquired
  169. again.
  170.  
  171. When 'clean' is off, expired records will be retained; if no
  172. replacement can be obtained from another domain name server,
  173. these records will continue to be used.
  174.  
  175. When 'clean' is on, expired records will be removed from the file
  176. whenever any new record is added to the file.
  177.  
  178.  
  179. >> Example:  domain cache clean on
  180.  
  181.  
  182. _________________________________________________________________
  183. domain cache list
  184. _________________________________________________________________
  185. List the current contents of the local in-memory cache.
  186.  
  187. >> Example of output from the 'domain cache list' command:
  188. ..............................................................
  189. : ns9mhb.ampr.org.     IN   A       44.199.41.6              :
  190. : ns9zzz.ampr.org.     IN   MX      0       ns9mhb.ampr.org. :
  191. : ns9gwa.ampr.org.     IN   A       44.199.41.4              :
  192. : ns9bob.ampr.org.     IN   A       44.199.41.1              :
  193. : nosland.ampr.org.    IN   A       44.199.0.0                       :
  194. :............................................................:
  195.  
  196.  
  197. _________________________________________________________________
  198. domain cache size [<entries>]                         Default: 20
  199. _________________________________________________________________
  200. Display or set the nominal maximum size of the local memory
  201. cache.
  202.  
  203. Note: The cache may be temporarily larger when waiting for new
  204. records to be written to /domain.txt.
  205.  
  206. >> Example:  domain cache size 30
  207.  
  208.  
  209. _________________________________________________________________
  210. domain cache wait <seconds>                          Default: 300
  211. _________________________________________________________________
  212. Display or set the interval to wait for additional activity
  213. before updating /domain.txt.
  214.  
  215. >> Example:  domain cache wait 600
  216.  
  217.  
  218. _________________________________________________________________
  219. domain dropserver <host> [<host> ...]
  220. _________________________________________________________________
  221. Remove one or more domain name server(s) from the list of name
  222. servers.  You are warned when you delete the last name server.
  223.  
  224. >> Example:  domain dropserver ns9srv
  225.  
  226.  
  227. _________________________________________________________________
  228. domain list
  229. _________________________________________________________________
  230. List the currently configured domain name servers, along with
  231. statistics on how many queries and replies have been exchanged
  232. with each one, response times, etc.
  233.  
  234.  
  235. _________________________________________________________________
  236. domain maxwait <seconds>                              Default: 60
  237. _________________________________________________________________
  238. This sets a timeout value (1 to 255 seconds) to a query or domain
  239. name server.  This is not set for an already defined server, but
  240. will be used for a newly defined name server.  Also the value is
  241. used for domain nslookups.  Note that name servers can have (PC-
  242. based) trouble finding records in an large database.
  243.  
  244. >> Example:  domain maxwait 120
  245.  
  246.  
  247. _________________________________________________________________
  248. domain query <host>
  249. _________________________________________________________________
  250. Send a query to a domain server asking for all resource records
  251. associated with this <host>, and list the records.
  252.  
  253. >> Example:  domain query ns9srv
  254.  
  255.  
  256. ________________________________________________________________
  257. domain remote add <host> [<host> ...]
  258. ________________________________________________________________
  259. Same as 'domain addserver'
  260.  
  261.  
  262. _________________________________________________________________
  263. domain remote drop <host> [<host> ...]
  264. ________________________________________________________________
  265. Same as 'domain dropserver'
  266.  
  267.  
  268. _________________________________________________________________
  269. domain remote list
  270. _________________________________________________________________
  271. Same as 'domain list'.
  272.  
  273.  
  274. _________________________________________________________________
  275. domain remote retry [<n>]                              Default: 2
  276. _________________________________________________________________
  277. Same as 'domain retry'
  278.  
  279.  
  280. _________________________________________________________________
  281. domain remote trace [on|off]                         Default: off
  282. _________________________________________________________________
  283. Same as 'domain trace'
  284.  
  285.  
  286. _________________________________________________________________
  287. domain retry [<n>]                                     Default: 2
  288. _________________________________________________________________
  289. Display or set the number of attempts to reach each server on the
  290. list during one call to the resolver.  If this count is exceeded,
  291. a failure indication is returned.
  292.  
  293. If set to 0, the list will cycle forever; this may be useful for
  294. unattended operation.
  295.  
  296. >> Example:  domain retry 10
  297.  
  298.  
  299. _________________________________________________________________
  300. domain suffix [<domain_suffix>]                Default: ampr.org.
  301. _________________________________________________________________
  302. Display or specify the default domain name suffix to be appended
  303. to a host name when it contains no dots.
  304.  
  305. For example, if the suffix is set to ampr.org. and the user
  306. enters 'telnet ns9bob', the domain resolver will attempt to find
  307. ns9bob.ampr.org.
  308.  
  309. If the host name being sought contains one or more dots, however,
  310. the default suffix is NOT applied (e.g. 'telnet foo.bar' would
  311. NOT be turned into foo.bar.ampr.org).
  312.  
  313. If the suffix is an empty string, with no dot, the current suffix
  314. is cleared.
  315.  
  316. >> Example:  domain suffix ampr.org.
  317.  
  318.  
  319. _________________________________________________________________
  320. domain trace [on|off]                                Default: off
  321. _________________________________________________________________
  322. Display or set the flag controlling the tracing of domain server
  323. requests and responses.  Trace messages will be seen only if a
  324. domain name being sought is not found in the local cache file,
  325. /domain.txt.
  326.  
  327. >> Example:  domain trace on
  328.  
  329.  
  330. _________________________________________________________________
  331. domain translate [on|off]                             Default: on
  332. _________________________________________________________________
  333. Display or set the domain translate mode.  When set to 'on',
  334. hosts are displayed as names.  This is the more useful setting
  335. (but unfortunately some versions of NOS are broken, so that even
  336. if translate is set to 'on', no translation takes place).
  337.  
  338. When set to 'off', hosts are displayed as IP addresses.
  339.  
  340. >> Example:  domain translate off
  341.  
  342.  
  343. _________________________________________________________________
  344. domain verbose [on|off]                              Default: off
  345. _________________________________________________________________
  346. Display or set the domain verbose mode.  When set to 'off', only
  347. the host name is displayed, without the domain suffix.  This is
  348. the more useful setting.
  349.  
  350. When set to 'on', the full host name with suffix is displayed.
  351.  
  352. >> Example:  domain verbose on
  353.  
  354.  
  355. _________________________________________________________________
  356. domain xyzzy
  357. _________________________________________________________________
  358. This is a magic word to enable domain queries to outside domain
  359. servers when reading commands from the startup file.  This should
  360. only be used by those who have reliable access to a domain name
  361. system server.
  362.